home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr33 / iconmk11.zip / ICONMAKE.DOC < prev    next >
Text File  |  1993-06-12  |  11KB  |  265 lines
  1.                               ICONMAKE 1.1
  2.                     written by Marcus Groeber 1992/93
  3.                             Fido: 2:2402/61.1
  4.  
  5. Iconmake ermöglicht die Erstellung eigener Icons für PC/Geos, die über die
  6. GEOS.INI-Datei bestimmten Dos-Dateien zugeordnet werden können. Das Verfahren
  7. basiert auf der von Geoworks selbst herausgegebenen PD-Icon-Sammlung; die
  8. Einbindung der neuen Icons in Geos erfolgt auf die selbe Weise.
  9.  
  10. ---
  11. Wer bereits Erfahrungen mit ICONMAKE 1.0 hat, sollte insbesondere den
  12. Abschnitt "Tokens aus Geoworks-Dateien" berücksichtigen - er beschreibt z.B.
  13. wie existierende Icons aus der 1.x in Geoworks 2.0 übernommen werden können.
  14.  
  15. Das beiliegende Batchfile ICONVERT.BAT konvertiert ein ganzes Verzeichnis
  16. alter Icons ins neue 2.0-Format. Der Aufruf kann einfach mit
  17.  
  18.         ICONVERT alter_pfad neuer_pfad
  19.  
  20. erfolgen. ICONMAKE muß für diese Funktion im aktuellen Verzeichnis stehen.
  21. Das Batchfile ICON2TO1.BAT konvertiert in die umgekehrte Richtung (2.0 nach
  22. 1.x).
  23. ---
  24.  
  25.  
  26. Die Technik
  27. -----------
  28. Um Geoworks neue Icons beizubringen, müssen sogenannte "Tokens" erzeugt
  29. werden; dabei handelt es sich um Referenzen auf ausführbare Programme oder um
  30. Dokumentdatei-Typen (bestehend aus einem 4-Buchstaben-Code und einer Zahl im
  31. Bereich 0..65535), die normalerweise für jedes Geoworks-Programm angelegt
  32. werden. Einem "Token" kann u.a. ein Programmname, ein oder mehrere Icons (für
  33. unterschiedliche Bildschirmtypen) und evtl. der Name der Anwendung, die die
  34. Datei erzeugt hat, zugeordnet werden.
  35.  
  36. Beim Öffnen eines Verzeichnisse lädt Geoworks automatisch aus allen
  37. Anwendungen, deren "Tokens" noch unbekannt sind, diese Tokens in eine interne
  38. Datei (TOKEN.DB). Ein neues Token kann also einfach über eine
  39. "Dummy-Anwendung" erzeugt werden, die nichts anderes tut, als die Icons für
  40. dieses Token zu enthalten. Indem man einmal mit dem Dateimanager in das
  41. Verzeichnis mit dieser Datei wechselt, wird das Token (mit den Icons)
  42. automatisch im System installiert.
  43.  
  44.  
  45. Der Konverter
  46. -------------
  47. ICONMAKE ermöglicht nun, aus einer Reihe von PCX-Dateien (PC-Paintbrush, z.B.
  48. von Windows :-) erzeugt) ein "Dummy" für ein solches Token zu erzeugen.
  49. Außerdem können ICO-Files (Icon-Dateien) von Windows direkt umgewandelt
  50. werden, wodurch Zugriff auf eine riesige Anzahl existierender Grafiken möglich
  51. ist.
  52.  
  53. Für die Konvertierung wird ein Codefragement aus der ursprünglichen
  54. Geoworks-Iconsammlung (eigentlich (c) Geoworks) verwendet, in das ICONMAKE nur
  55. noch die entsprechenden Bilder einfügt.
  56.  
  57.  
  58. Wichtig: Geoworks-Versionen 1.x und 2.0
  59. ---------------------------------------
  60. Um richtig "zukunftssicher" zu sein, ist die Defaulteinstellung von ICONMAKE
  61. bereits Geoworks 2.0, d.h. die erzeugten Icon-Dateien sind für nur für diese
  62. Version geeignet.
  63.  
  64. Um dennoch Icons für die Version 1.x zu erzeugen, muß an zweiter Stelle
  65. (hinter dem Kommandobuchstaben, s.u.) die Option "/O" ("old") angeben werden,
  66. z.B.
  67.  
  68.         ICONMAKE w /O \geoworks\icons\TEST,12345 test.ICO
  69.  
  70. um das Windows-Icon TEST.ICO in ein Geoworks 1.x-Icon umzuwandeln.
  71.  
  72.  
  73. Tokens aus PCX-Dateien
  74. ----------------------
  75. Für jedes Token werden drei Icon-Dateien benötigt (Tokenname sei xxxx, Namen
  76. sind nur Vorschläge):
  77.  
  78.   xxxx_CGA.PCX          Icon in niedriger Auflösung: 48x14 Pixel, monochrom
  79.   xxxx_HGC.PCX          Icon monochrom hochauflösend: 48x30 Pixel, monochrom
  80.   xxxx_EGA.PCX          Icon farbig hochauflösend: 48x30 Pixel, 16 Farben
  81.  
  82. Um daraus ein "Dummy" für das Token xxxx zu erzeugen (Name xxxx.000), muß das
  83. Kommando
  84.  
  85.         ICONMAKE m xxxx <Liste der PCX-Dateien>
  86. z.B.:   ICONMAKE m icons\TEST,12345 test_cga.pcx test_hgc.pcx test_ega.pcx
  87.  
  88. eingegeben werden. Wird hinter xxxx noch (durch ein Komma getrennt) eine Zahl
  89. angegeben, so wird das Nummernfeld des Tokens auf den entsprechenden Wert
  90. (default 255) gesetzt. Dieses Feature kann z.B. verwendet werden, um
  91. gleichnamige Tokens verschiedener Sammlungen auseinanderzuhalten.
  92.  
  93. Zusätzlich kann der Tokenname auch noch einen Pfadnamen enthalten, unter dem
  94. die erzeugte Datei abgelegt wird. Eine eventuelle Extension wird ignoriert;
  95. der Name wird automatisch auf 4 Zeichen gekappt. Daher können in automatischen
  96. Batchläufen z.B. die Namen der zu konvertierenden Dateien sofort als Iconnamen
  97. verwendet werden. Es wird niemals eine existierende Datei überschrieben,
  98. sondern das Programm ändert ggf. den Namen des Tokens so ab, daß es keine
  99. Duplikate gibt.
  100.  
  101. Als Dateiname für die Tokendatei wird der Tokenname, zusammen mit der
  102. Tokennummer (in hexadezimaler Darstellung) verwendet. Die Extension ist immer
  103. "000".
  104.  
  105. Im Normalfall werden alle Punkte mit der Farbe 14 als transparent dargestellt
  106. (Hintergrund scheint durch), indem man nach dem "m" die Option "/m", zusammen
  107. mit einem Farbcode, angibt (z.B. "/m1"), kann diese Farbe geändert werden. Die
  108. Angabe "/m0" schaltet die Transparenz des Icons aus. Folgende Farbcodes können
  109. verwendet werden:
  110.  
  111.                 Schwarz  1           Dunkelgrau  9
  112.                    Blau  2             Hellblau  10
  113.                    Grün  3             Hellgrün  11
  114.                    Cyan  4             Hellcyan  12
  115.                     Rot  5              Hellrot  13
  116.                 Magenta  6          Hellmagenta  14
  117.                   Braun  7                 Gelb  15
  118.                Hellgrau  8                 Weiß  16
  119.  
  120.  
  121. Tokens aus PC/Geos-Dateien auslesen
  122. -----------------------------------
  123. Mit dem Kommando
  124.  
  125.         ICONMAKE x <dateiname> [<zielpfad>]
  126.  
  127. können Icon-Definitionen aus existierenden Geoworks-Programmen (oder Dummys)
  128. in PCX-Dateien ausgelesen werden (erzeugte Namen: siehe Beispiel oben). Wird
  129. für <zielpfad> ein Pfadname (evtl. mit einem vierstelligen Dateinamens-Präfix)
  130. angegeben, werden die PCX-Dateien unter dem angegebenen Namen erzeugt. Wenn
  131. nur ein Pfad angegeben wird, muß er mit "\" enden, damit er korrekt erkannt
  132. wird.
  133.  
  134.  
  135. Tokens aus Windows-ICO-Dateien erzeugen
  136. ---------------------------------------
  137. Mit dem Kommando
  138.  
  139.         ICONMAKE w xxxx <ICO_Datei>
  140. z.B.:   ICONMAKE w \geoworks\icons\TEST,12345 test.ICO
  141.  
  142. wird für das Token xxxx (Regeln: siehe PCX-Dateien) ein Dummy aus der
  143. angegebenen Windows-Icon-Datei erzeugt. Es wird versucht, möglichst viele
  144. Auflösungen (CGA, HGC, EGA) zu erzeugen; ICONMAKE wirkt beim Konvertieren
  145. allerdings keine Wunder. Entweder ein Bild ist in passender Auflösung
  146. vorhanden - oder eben nicht... Die erzeugten Bilder haben im Gegensatz zum
  147. Geoworks-Standard die Auflösung 32x32 (nicht 48x30), was aber normalerweise
  148. keine Probleme macht.
  149.  
  150.  
  151. Tokens aus Geoworks-Dateien erzeugen
  152. ------------------------------------
  153. Diese Option holt das Programm-Icon aus einem ausführbaren Geoworks-Programm
  154. ("Geode") oder Icon-Dummy und überträgt es in ein separates "Dummy"-Icon.
  155. Dabei wird das Bild ggf. zwischen Geoworks 1.x und 2.0 konvertiert. Der Aufruf
  156. dafür muß mit
  157.  
  158.         ICONMAKE g xxxx <Geoworks_Datei>
  159. z.B.:   ICONMAKE g \geoworks\icons\test,123 \geoworks\world\draw.geo
  160.  
  161. erfolgen, wobei xxxx der Name des zu erzeugenden Tokens (evtl. mit Pfad) ist.
  162. Die Beispielzeile holt das Icon aus dem Programm GeoDraw und legt es als
  163. Icon-Dummy für das Token TEST.123 im Verzeichnis icons ab. Wird auf den
  164. Namen des Tokens verzichtet, übernimmt ICONMAKE den Namen des Originaltokens.
  165. In diesem Fall muß ein Pfad, falls angegeben, mit einem "\" enden.
  166.  
  167. Anwendungen für diese Funktion:
  168.  
  169.  - Konvertieren von Icons zwischen Geoworks 1.x und 2.0, indem einfach das
  170. Icon aus der alten Datei in eine neue im gewünschten Format ausgelesen wird.
  171.  
  172.  - Übertragen von Icons kompletter Programme in separate Dateien, um sie
  173. weiterbearbeiten zu können.
  174.  
  175.  - Kopieren bestehender Icons unter Änderung des Tokens (denn Tokens müssen
  176. eindeutig sein).
  177.  
  178.  
  179. Parameterdateien
  180. ----------------
  181. Da DOS leider immer noch die Länge von Parametern, die man an Programme
  182. übergeben kann, auf 126 Zeichen beschränkt, wurde ICONMAKE mit der Möglichkeit
  183. ausgestatt, beliebige Kommandozeilenparameter alternativ aus einer Datei
  184. einzulesen. Dazu muß an der entsprechenden Zeile einfach nur der Parameter
  185. @<Filename> eingefügt werden. Die Datei <Filename> kann dann beliebig viele
  186. Paramter enthalten, allerdings nicht durch Leerzeichen, sondern durch
  187. Zeilenvorschübe getrennt.
  188.  
  189. In den einfachsten Fällen ist das eine Liste von Dateinamen, also z.B.
  190.  
  191.         ICONMAKE m TEST,123 @FILES.LST
  192.  
  193. mit einer Liste der zu konvertierenden Dateien in FILES.LST:
  194.  
  195.         test_ega.pcx
  196.         test_hgc.pcx
  197.         test_cga.pcx
  198.  
  199. Es können aber auch beliebige anderen Kombinationen von Parametern und
  200. Parameterdateien verwendet werden.
  201.  
  202. Diese Aufrufart ist vor allem für die "Fernsteuerung" von ICONMAKE durch
  203. andere Programme interessant...
  204.  
  205.  
  206. Tips:
  207. -----
  208.  - Zu beachten ist, daß ein Token von Geoworks nicht neu eingelesen wird, wenn
  209. der Token-Dummy geändert wird. In diesem Fall muß die Datei TOKEN.DB im
  210. Verzeichnis SYSTEM (bzw. TOKEN_DA.000 in PRIVDATA) gelöscht werden - dabei
  211. gehen alle Tokens verloren und müssen erst durch erneutes Öffnen der
  212. Verzeichnisse mit den entsprechenden Dateien wieder installiert werden.
  213.  
  214.  - Evtl. hilft bei einigen Malprogrammen (z.B. Windows Paintbrush) erneutes
  215. Laden und Abspeichern einer PCX-Datei, um Farbprobleme zu vermeiden.
  216. Ausprobieren!
  217.  
  218.  - Wie schon gesagt, ist der schnellste Weg zu massenweise Geos-Icons, sich
  219. eine Windows-PD-Iconsammlung vorzunehmen und die Bilder einfach
  220. "durchzunudeln". Sind sie in EXEs oder DLLs gepackt, muß vorher ein
  221. entsprechender Konverter (z.B. GETICONS von Daniel Tietze) verwendet werden.
  222.  
  223.  - Folgende Zeile konvertiert alle Windows-Icons in eine Verzeichnis (Achtung:
  224. Die Namen müssen sich in den ersten 4 Zeichen unterscheiden):
  225.  
  226.         FOR %a IN (*.ICO) DO iconmake w %a,254 %a
  227.  
  228. Dabei wird allen Tokens die Tokennumer 254 (kann frei gewählt werden,
  229. 0..65535) zugeordnet. Man sollte sich allerdings nicht wundern, wenn die
  230. meisten Windows-Iconsammlungen nur Bilder für EGA/VGA-Auflösung enthalten. :-)
  231.  
  232.  - Um alle Geoworks-1.x-Icons eines Verzeichnisses ins neue Format zu
  233. konvertieren, ist folgende Zeile nützlich:
  234.  
  235.         FOR %a IN (icons1\*.*) DO iconmake g icons2\ %a
  236.  
  237. Sie erzeugt für jede Datei im Verzeichnis icons1 (es sollte sich dabei nur
  238. um Icon-Dateien handeln) ein neues Icon im Verzeichnis icons2, das im
  239. Geoworks 2.0-Format gespeichert ist. Tokenname und -nummer bleiben erhalten.
  240.  
  241.  - Noch ein paar nützliche Programme im Zusammenhang mit Geoworks-Icons:
  242.  
  243.    * ICONED von Thomas Wachsmann ist ein waschechter Iconeditor, gibt's
  244.      inzwischen auch unter Geoworks 1.x.
  245.  
  246.    * TOKENVM von Rudi Ferrari ermöglicht es, die Tokens, die einem
  247.      Geos-Dokument-Icon zugeorndet sind, nachträglich zu ändern, so daß z.B.
  248.      ein GeoWrite-Text mit einem zum Inhalt passenden Bildchen versehen
  249.      werden kann.
  250.  
  251.  
  252. Neue Versionen
  253. ==============
  254. 1.0
  255.         Erste Version
  256.  
  257. 1.01
  258.         Wildcards für Dateinamen und Parameterdateien möglich
  259.         Überarbeitetes PCX-Import-Modul, entsprechend BKGD2PCX 2.2a
  260.  
  261. 1.1
  262.         Unterstützung von Geoworks 2.0
  263.         Einige Paramter leicht überarbeitet
  264.         Neue Funktion, um Icons aus Geoworks-Files zu extrahieren/konvertieren
  265.